home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / GAMEORTS / BATTERUP.LZH / BALL.DOC < prev    next >
Text File  |  1988-07-04  |  18KB  |  413 lines
  1.        <<<<<<<<<<<< THIS DOCUMENTATION IS IN FILE BALL.DOC >>>>>>>>>>>>
  2.  
  3.        THE BASEBALL PROGRAM DESCRIBED BELOW HAS A REGISTERED COPYRIGHT
  4.                                   (BALL.V18)
  5.                             DATED 22 OCTOBER 1986.
  6.  
  7.                           THIS PROGRAM MAY BE FREELY
  8.                           DISTRIBUTED  ONLY  IN  ITS
  9.                           ORIGINAL AND COMPLETE FORM
  10.                           PROVIDED SUCH DISTRIBUTION
  11.                           IS MADE WITHOUT CHARGE.
  12.  
  13.  
  14.      This is a summary of the BASEBALL (BALL.V18) program. It presents
  15.      installation steps, in case of trouble information, and requirements and
  16.      features of the game.
  17.  
  18.      The BASEBALL (BALL.V18) program is not a public domain or free program!
  19.      It is being distributed as Shareware which gives users a chance to try
  20.      software before buying. If you try BASEBALL (BALL.V18) and continue using
  21.      it, you are expected to register. Registration licenses you to use
  22.      BASEBALL (BALL.V18) and future updates. Any unregistered use other than
  23.      trial use to determine if BASEBALL (BALL.V18) meets your needs is a
  24.      violation of the license agreement and is forbidden. A nominal charge may
  25.      be made for copying and mailing expenses only.
  26.  
  27.      YOU START THIS PROGRAM BY TYPING "BASEBALL", WITHOUT THE QUOTE MARKS AND
  28.      ONCE STARTED YOU QUIT DURING PLAY WITH THE "F1" KEY OR BY ANSWERING
  29.      PROMPTS DISPLAYED AT END OF A GAME!
  30.  
  31. INSTALLATION
  32.  
  33.      1. Make sure you have the following sixteen (16) files:
  34.  
  35.           EXECUTABLE          DOCUMENTATION            USED BY PROGRAM
  36.  
  37.           BASEBALL.EXE        README.DOC               BALL.DLY
  38.           NEWRCD.BAT          LICENSE.DOC              BASEBALL.RCD
  39.           DLYBLD.BAS          BALL.DOC                 BAT.RCD
  40.                                                        NORCD.DMY
  41.                                                        CLK47.DLY
  42.                                                        CLK8.DLY
  43.                                                        CLK12.DLY
  44.                                                        CLK16.DLY
  45.                                                        CLK20.DLY
  46.                                                        GNAME.PIC
  47.  
  48.         If you don't have all files, you must get them before proceeding.
  49.  
  50.      2. Make a backup and copy all files to the same directory that you plan
  51.      to use.
  52.  
  53.      3. The files listed above under column "USED BY PROGRAM" contains six (6)
  54.      files with the extension ".DLY". The file "BALL.DLY" is used during
  55.      execution to determine the length of time various things are displayed on
  56.      the screen and it has values for a computer with a clock speed of 4.7Mhz.
  57.  
  58.      If you know that your computer has a clock speed of 4.7Mhz you don't have
  59.      to change anything. Type "BASEBALL" and go to step c below.
  60.  
  61.  
  62.      If you know that your computer has a clock speed different than 4.7Mhz,
  63.      then you must make the simple change:
  64.  
  65.           a. Delete the file "BALL.DLY" and create a new file "BALL.DLY" with
  66.           the contents of the appropriate "CLK--.DLY" file. The clock speed of
  67.           each "CLK--.DLY" file is shown by the integer part of the name where
  68.           47 = 4.7Mhz and 8, 12, 16, and 20 = Mhz. Type "BASEBALL" and go to
  69.           step c below.
  70.  
  71.  
  72.           b. If you don't know what the clock speed of your computer is, try
  73.           the program by typing "BASEBALL", without the quote marks, and see
  74.           what things look like. If screen movement appears too fast, your
  75.           machine is probably faster than 4.7Mhz so try making a new
  76.           "BALL.DLY" file as described (a.), above.
  77.  
  78.           c. If after you typed "BASEBALL" you could not start the game, go to
  79.           step 4 for start up problems.
  80.  
  81.           d. If after you typed "BASEBALL" and everything seems OK, your done
  82.           with installation. Go to step 5.
  83.  
  84.           e. INTERPRETIVE BASIC GENERATION OF "BALL.DLY".
  85.  
  86.           This BASIC program "DLYBLD.BAS" is provided to adjust delay values
  87.           for computers of different clock speeds from 4.7 Mhz to 20 Mhz if
  88.           you don't like delays provided. Get into your BASIC and execute
  89.           "DLYBLD.BAS" to set delays.  The program will prompt you for what
  90.           entries are needed and will generate the file "BALL.DLY". Type
  91.           "BASEBALL" and go to step c above.
  92.  
  93.  
  94.      4. If you have start up problems:
  95.  
  96.           a. Make sure you have the files "BASEBALL.RCD" and "BAT.RCD" in the
  97.           same directory (all files should be in same directory) that you
  98.           copied files to in step 2.
  99.  
  100.           b. If neither of the above files exist, make sure the file
  101.           "NORCD.DMY" exists and that it is in the directory that you copied
  102.           files to in step 2.
  103.  
  104.           c. If neither a or b is satisfied, enter the following ASCII text to
  105.           a file named "NORCD.DMY" in the directory that files were copied to
  106.           in step 2 exactly as shown. The text shown is what the file
  107.           "NORCD.DMY" must contain.
  108.  
  109.           0
  110.           0,"01-01-1986","GIANTS","RJY"
  111.           0,"01-01-1986","GIANTS","RJY"
  112.           0,"01-01-1986","GIANTS","RJY"
  113.           0,"01-01-1986","GIANTS","RJY"
  114.           .001,"01-01-1986","GIANTS","RJY"
  115.           .999,"01-01-1986","GIANTS","RJY"
  116.           0,"01-01-1986","GIANTS","RJY"
  117.           1,"01-01-1986","GIANTS","RJY","GIANTS","RJY"
  118.           1.,"01-01-1986","GIANTS","RJY"
  119.           1,"01-01-1986","GIANTS","RJY"
  120.           1.,"01-01-1986","GIANTS","RJY"
  121.  
  122.  
  123.           c. If you still have problems, make sure the file "GNAME.PIC" exists
  124.           in the directory you copied files to in step 2. If it does not
  125.           exist, you must get everything again because you cannot create this
  126.           file yourself.
  127.  
  128.      5. You are now ready to play but should read the rest of this document
  129.      first.
  130.  
  131.      If you have problems and are a licensed user, I will assist you. Send
  132.      information, including Version # and where you acquired the program, to
  133.      the following address.
  134.  
  135.                                Russell J. Yuma
  136.                                2111 Latham #121
  137.                             Mountain View, Calif.
  138.                                     94040
  139.  
  140.               USE VERSION REFERENCE # V18 FOR PROBLEM REPORTING
  141.  
  142.  
  143.                     <<<<<<<<<<     CAUTION     >>>>>>>>>>
  144.  
  145.      NOTE: The files "BASEBALL.RCD" and "BAT.RCD" are provided only to have
  146.      some data for display when you play and complete your first game. After
  147.      you have installed everything you can delete these files and start record
  148.      files of your own. 
  149.  
  150.      If you want to start the record's files ("BASEBALL.RCD" and "BAT.RCD")
  151.      over do the following:
  152.  
  153.      1. Save the current files "BASEBALL.RCD" and "BAT.RCD", if you want to,
  154.      using DOS and make sure you use different file names.
  155.  
  156.      2. Always delete, after you save, files "BASEBALL.RCD" and "BAT.RCD" with
  157.      the provided batch file "NEWRCD.BAT". This BAT file will not delete the
  158.      needed "BASEBALL.RCD" and "BAT.RCD" unless the file "NORCD.DMY" exists.
  159.  
  160. HARDWARE REQUIREMENTS
  161.  
  162.      The version of BASEBALL (BALL.V18) provided requires a MONOCHROME or
  163.      COLOR DISPLAY, at least one disk drive, and a system with at least 128K
  164.      of memory above operating system requirements. It has been tested on IBM
  165.      PC, IBM XT, and IBM ATs and compatibles and will work with a single disk,
  166.      two disks, or hard disk systems and systems with RAM disks. Limited
  167.      testing has been done on systems with Hurcules.
  168.  
  169.  
  170. SOFTWARE REQUIREMENTS
  171.  
  172.     This program requires IBM DOS 2.0, or above, or the equivalent.
  173.  
  174.  
  175.                              <<< DEFINITIONS >>>
  176. PLAYERS
  177.  
  178.     Players means the number of persons playing the game.  This game allows
  179.     one or two players.  When two players are selected, keys on the right
  180.     and left side of the keyboard are activated.  With one player selected,
  181.     keys on the left side of the keyboard are activated.
  182.  
  183.  
  184. TEAMS
  185.  
  186.     Teams means the baseball teams in the game. There are always two teams
  187.     regardless of the number of players.
  188.  
  189.                           <<< END OF DEFINITIONS >>>
  190.  
  191. FEATURES
  192.  
  193.  
  194. 1.  Each player is identified by a one to three character ID for a record
  195.     file. When only one player is selected only one player ID is required.
  196.  
  197. 2.  Each team is identified by a one to twelve character name. You must
  198.     enter two team names regardless of how many players are selected.
  199.  
  200. 3.  There are three levels of skill, one of which may be selected and
  201.     assigned to each team.  A skill level is required for each team, not
  202.     necessarily the same, regardless of the number of players.  Effects of
  203.     skill selection are subtle and apparent.
  204.  
  205. 4.  A summary similar to a box score is displayed at end of game.
  206.  
  207. 5.  A records file is displayed at the start and at the end of each game.
  208.     At the end of the game any new record(s) set during the game are
  209.     highlighted and the records are written to disk.
  210.  
  211. 6.  A statistics file is displayed at the end of each game. It contains the
  212.     line ups for each team with the following statistics for each player:
  213.     at bats, hits, singles, doubles, triples, home runs, walks, strike
  214.     outs, double plays hit into, and batting average. The top of the
  215.     display shows total games played and number won and lost by each team.
  216.     The bottom of the display shows total team statistics. Because of the
  217.     amount of data displayed, the statistics are displayed separately for
  218.     each team.
  219.  
  220. 7.  At the end of the game an option is presented to play another game with
  221.     same players and teams or different players, teams, and skill levels.
  222.  
  223. 8.  Color is used for a color monitor, and highlighting and reverse image
  224.     is used for monochrome monitor, automatically.
  225.  
  226. 8.  Music of "TAKE ME OUT TO THE BALL GAME" is played and sound is provided
  227.     for errors of entry and for pitches, hits, and outs. The music and
  228.     sound can be turned off and on with function key F8.
  229.  
  230. 9.  Games of extra innings are supported.
  231.  
  232. 10. A score board is displayed and updated as play progresses.
  233.  
  234. 11. An auxiliary board of balls, strikes, and outs is displayed and updated
  235.     on each pitch.
  236.  
  237. 12  An action board of action and team batting averages is displayed and
  238.     updated as play progresses.
  239.  
  240. 13. Home and visitor line ups can be displayed. Each display shows the
  241.     current batter (marked with a flashing "*"), the player's position,
  242.  
  243.     batting average for all games, (ie.  season) and at bats and hits for
  244.     current game.  The visitor line up is on the right and is turned on/off
  245.     with the cursor down key, and the home line up is on the left and is
  246.     turned on/off with function key F6.
  247.  
  248. 14. The players of each team are represented on a "bench" and adjusted as
  249.     play progresses.
  250.  
  251. 15. At bat team players move to "on deck" and "at bat" positions.
  252.  
  253. 16. A batter is positioned as batting left or right.
  254.  
  255. 17. A pitched ball moves on the screen from pitcher to catcher.
  256.  
  257. 18. If a pitched ball is swung at and missed it is a strike. If not swung
  258.     at it may be a strike or a ball.
  259.  
  260. 19. An umpire figure appears briefly to indicate balls and strikes.
  261.  
  262. 20. A "hit" ball moves, on the screen, foul or fair.
  263.  
  264. 21. A ball "hit" fair may be a single, double, triple, home run, or an out.
  265.  
  266. 22. A full screen message with a figure jumping across the screen is
  267.     displayed for home runs.
  268.  
  269. 23. A ball "hit" for an out may simply be an out or it may be a sacrifice
  270.     fly, fielders choice, or a double play.
  271.  
  272. 24. Runners are displayed on the bases and they advance, on the screen,
  273.     according to total bases for a hit, one base for a walk, and movement
  274.     is shown for all outs.
  275.  
  276. 25. Runners on base may steal second and third base and movement is shown
  277.     on the screen for both runners and the catcher's throw.
  278.  
  279. 26. The game is played with function keys and the keys used depend upon how
  280.     many players there are.
  281.  
  282. 27. The active function keys are displayed during the game on line 25 with
  283.     an explanation. The keys used are F6, F7, F8, and F9; and the cursor
  284.     Left, Right, Up, Down.
  285.  
  286. 28. Function key F5 is not shown because of space limitations, but when
  287.     depressed the game is interrupted and team statistics are shown and
  288.     then the game is resumed (see #6 above).
  289.  
  290. 29. The game may be terminated at any time with function key F1.
  291.  
  292. 30. A clock display is shown in the upper left corner while the game is being
  293. played. It is active only while the game is being played and its purpose is to
  294. show you that the BASEBALL game is still active, waiting for input, and most
  295. importantly, the BASEBALL program is still alive and not hung up.
  296.  
  297.                  <<<<<<<<<< MAINTENANCE NOTES V15 >>>>>>>>>>
  298.  
  299.     The BASEBALL.EXE file has been made from the source in directory \SHWARE
  300.     which is the version for Quick Basic 4.0.  The Quick Basic V4.0 has
  301.     changes to execute correctly when either BASEBALL.RCD or BAT.RCD files
  302.     are not present.
  303.  
  304.  
  305.     One problem was that the record lengths of a newly created BASEBALL.RCD
  306.     file were not always 80 bytes and this caused RCDTXT.ASM to put garbage
  307.     on the screen, forever.
  308.  
  309.     FIX - The file NORCD.DMY must be present whenever BASEBALL.RCD is not
  310.     present.
  311.  
  312.  
  313.     The second problem was that without a BAT.RCD file it is possible that
  314.     the presentation of the team summary could cause a divide by zero if
  315.     any batter had zero at bats. Not likely, but in testing with a game of
  316.     1 inning instead of 9 it happens.
  317.  
  318.     FIX - Added a test so that no divide with a zero at bats is attempted.
  319.  
  320.     The third problem was in testing for visitor team setting a new record.
  321.  
  322.      FIX - Eliminated testing for visitor team statistic equal to home team
  323.      statistic. That was a wrong translation of BASEBALL (BALL.V15) BASICA
  324.      code to structured IF STATEMENTS in Quick Basic V4.0.
  325.  
  326.     Added the batch file NEWRCD.BAT to delete BASEBALL.RCD and BAT.RCD with
  327.     a caution that Ctrl-Break can abort and a delete will not be done if the
  328.     file NORCD.DMY does not exist.
  329.  
  330.                 <<<<<<<<<< END MAINTENANCE NOTES V15>>>>>>>>>>
  331.  
  332.                  <<<<<<<<<< MAINTENANCE NOTES V16 >>>>>>>>>>
  333.  
  334.      BALL.BAS (V15)
  335.  
  336.      Corrective code added for condition when:
  337.  
  338.      Bases loaded, less than two outs and ball hit to an infielder.
  339.  
  340.      V15 would show all runners move, no score, and wrong action message.
  341.  
  342.      V16 will show all runners move and out is at Home Plate x-2. 27 April 88.
  343.  
  344.      COMDEF.ASM (V15)
  345.  
  346.      Changed all V15s to V16s. 27 April 88.
  347.  
  348.      Changed 3rd line of RCD_HDR data to properly space TEAM PLYR text line
  349.      when records displayed. Cosmetic only so no version change. 11 May 88.
  350.  
  351.                <<<<<<<<<< END MAINTENANCE NOTES V16 >>>>>>>>>>
  352.  
  353.                  <<<<<<<<<< MAINTENANCE NOTES V17 >>>>>>>>>>
  354.  
  355.      BALL.BAS version V16 changed to not use BLOAD statement to show baseball
  356.      logo, GNAME.PIC, of BASEBALL. This was done to eliminate any possibility
  357.      of QB4 and this program from causing a problem on an AT&T 6300. The BLOAD
  358.      statement and all DSEG variable use was made into comments. The function
  359.      of BLOAD was replaced with a CALL LOGO which is a subroutine added to
  360.      COMDEF ASM. Also added subroutine name as comment to all ASM CALLs.
  361.  
  362.  
  363.      See notes under SHWARE from Dr. Hawkins. Ron Schaller tested what Hawkins
  364.      could not get to work and V17 and they both worked on a AT&T 6300. Ron
  365.      told me this on 11 June 88.
  366.  
  367.      COMDEF.ASM changed to add subroutine to read and display the file
  368.      GNAME.PIC.
  369.  
  370.      COMDEF.ASM changed title line to eliminate Version number.
  371.  
  372.      COMDEF.ASM changed comment line after title to show V17 and 13 June 88
  373.      and C_NOTIC to have 22 Oct 86 date.
  374.  
  375.      SETARRAY.ASM changed comment line after title to show V17 and 13 June 88
  376.      and C_NOTIC to have 22 Oct 86 date.
  377.  
  378.      BUP.ASM changed comment line after title to show V17 and 13 June 88 and
  379.      C_NOTIC to have 22 Oct 86 date.
  380.  
  381.      BIGMSG.ASM changed comment line after title to show V17 and 13 June 88
  382.      and C_NOTIC to have 22 Oct 86 date.
  383.  
  384.                <<<<<<<<<< END MAINTENANCE NOTES V17 >>>>>>>>>>
  385.  
  386.                  <<<<<<<<<< MAINTENANCE NOTES V18 >>>>>>>>>>
  387.  
  388.      BALL.BAS version V17 had a problem with displaying the record file. The
  389.      problem was that the DEF functions of FNRCDA$, FNRCDI$, and FNRCDL$ did
  390.      not always return the A$ string length as a multiple of 80 bytes. The
  391.      problem was caused by player ID and team Name string lengths not being
  392.      correctly accounted for. I could cause the program to crash with two
  393.      players with IDs of 1 and 2 byte lengths and team Names of 1 and 2 byte
  394.      lengths.
  395.  
  396.      When the ASM routine RCDTXT in COMDEF.ASM was called with an A$ string
  397.      length not equal to 880 the program would break. RCDTXT uses the A$
  398.      string length in multiples of 80 and when it is not a multiple of 80 the
  399.      routine moves things all over memory which causes a program crash.
  400.  
  401.      BALL.BAS changed. I removed the SPACE$(20) from the end of FNRCDA$ and
  402.      the SPACE$(T5) from the end of FNRCDI$ functions.
  403.  
  404.      I added a subroutine named MAKERCD80 which makes sure each of the eleven
  405.      (11) records for the record file will always be 80 bytes in length.
  406.  
  407.      I added a GOSUB MAKERCD80 after each call to functions FNRCDA$, FNRCDI$,
  408.      and FNRCDL$ in the subroutine PRINTRCD.
  409.  
  410.      This problem was reported by T&Z Software in a letter dated 28 June 1988.
  411.      See binder for letter.
  412.  
  413.